@codemirror/lang-javascript

What is @codemirror/lang-javascript?

@codemirror/lang-javascript is a language support package for CodeMirror 6 that provides syntax highlighting, code folding, and other language-specific features for JavaScript. It is part of the CodeMirror 6 ecosystem, which is a versatile text editor implemented in JavaScript for the browser.

What are @codemirror/lang-javascript's main functionalities?

Syntax Highlighting

This code sets up a basic CodeMirror editor with JavaScript syntax highlighting. The `javascript` function from `@codemirror/lang-javascript` is used to enable JavaScript language support.

import { javascript } from '@codemirror/lang-javascript';
import { EditorState } from '@codemirror/state';
import { EditorView, basicSetup } from '@codemirror/basic-setup';

const state = EditorState.create({
  doc: 'const x = 10;',
  extensions: [basicSetup, javascript()]
});

const view = new EditorView({
  state,
  parent: document.body
});

Code Folding

This code demonstrates how to set up code folding in a CodeMirror editor with JavaScript language support. The `foldGutter` extension is used alongside `@codemirror/lang-javascript`.

import { javascript } from '@codemirror/lang-javascript';
import { foldGutter } from '@codemirror/fold';
import { EditorState } from '@codemirror/state';
import { EditorView, basicSetup } from '@codemirror/basic-setup';

const state = EditorState.create({
  doc: 'function foo() {\n  console.log("bar");\n}',
  extensions: [basicSetup, javascript(), foldGutter()]
});

const view = new EditorView({
  state,
  parent: document.body
});

Linting

This code sets up a custom linter in a CodeMirror editor with JavaScript language support. The `linter` function from `@codemirror/lint` is used to create a custom linting extension.

import { javascript } from '@codemirror/lang-javascript';
import { linter } from '@codemirror/lint';
import { EditorState } from '@codemirror/state';
import { EditorView, basicSetup } from '@codemirror/basic-setup';

const myLinter = linter(view => {
  let diagnostics = [];
  // Custom linting logic here
  return diagnostics;
});

const state = EditorState.create({
  doc: 'const x = 10;',
  extensions: [basicSetup, javascript(), myLinter]
});

const view = new EditorView({
  state,
  parent: document.body
});

Other packages similar to @codemirror/lang-javascript

monaco-editor

Monaco Editor is the code editor that powers VS Code. It provides rich language support for JavaScript, including syntax highlighting, code folding, and linting. Compared to @codemirror/lang-javascript, Monaco Editor is more feature-rich and is designed to provide a similar experience to Visual Studio Code.

ace-builds

Ace is a standalone code editor written in JavaScript. It provides syntax highlighting, code folding, and other language-specific features for JavaScript. While it is similar to @codemirror/lang-javascript in terms of functionality, Ace is an older project and may not have the same level of modern features and extensibility as CodeMirror 6.

highlight.js

Highlight.js is a syntax highlighter written in JavaScript. It supports a wide range of languages, including JavaScript. Unlike @codemirror/lang-javascript, Highlight.js is focused solely on syntax highlighting and does not provide other editor features like code folding or linting.

README

@codemirror/lang-javascript

[ WEBSITE | ISSUES | FORUM | CHANGELOG ]

This package implements JavaScript language support for the CodeMirror code editor.

The project page has more information, a number of examples and the documentation.

This code is released under an MIT license.

We aim to be an inclusive, welcoming community. To make that explicit, we have a code of conduct that applies to communication around the project.

API Reference

javascript(config⁠?: {jsx⁠?: boolean, typescript⁠?: boolean} = {}) → LanguageSupport

JavaScript support. Includes snippet completion.

javascriptLanguage: LezerLanguage

A language provider based on the Lezer JavaScript parser, extended with highlighting and indentation information.

typescriptLanguage: LezerLanguage

A language provider for TypeScript.

jsxLanguage: LezerLanguage

Language provider for JSX.

tsxLanguage: LezerLanguage

Language provider for JSX + TypeScript.

snippets: readonly Completion[]

A collection of JavaScript-related snippets.

esLint(eslint: any, config⁠?: any) → fn(view: EditorView) → Diagnostic[]

Connects an ESLint linter to CodeMirror's lint integration. eslint should be an instance of the Linter class, and config an optional ESLint configuration. The return value of this function can be passed to linter to create a JavaScript linting extension.

Note that ESLint targets node, and is tricky to run in the browser. The eslint4b and eslint4b-prebuilt packages may help with that.